Revista do CD-ROM 101/CD-ROM 101.iso/compl/maya5ple/Install_MayaPLE5_English.exe/Maya/Data1.cab/performPointConstraint.mel

Text File | 2003-07-17 | 12.3 KB | 497 lines

// Copyright (C) 1997-2002 Alias|Wavefront,
// a division of Silicon Graphics Limited.
//
// The information in this file is provided for the exclusive use of the
// licensees of Alias|Wavefront.  Such users have the right to use, modify,
// and incorporate this code into other products for purposes authorized
// by the Alias|Wavefront license agreement, without fee.
//
// ALIAS|WAVEFRONT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
// INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
// EVENT SHALL ALIAS|WAVEFRONT BE LIABLE FOR ANY SPECIAL, INDIRECT OR
// CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
// DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
// TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
//
//
//  Alias|Wavefront Script File
//  MODIFY THIS AT YOUR OWN RISK
//
//  Creation Date:  24 April 1997
//
//  Description:
//        This script provides an option box dialog for the pointConstraint command.
//
//    Input Arguments:
//        boolean showOptionBox    true - show the option box dialog
//                                false - just execute the command
//

//
//  Procedure Name:
//      setOptionVars
//
//  Description:
//        Initialize the option values.
//
//  Input Arguments:
//        Whether to set the options to default values.
//
//  Return Value:
//      None.
//
proc setOptionVars(int $forceFactorySettings)
{
    //    weight
    //
    if ($forceFactorySettings || !`optionVar -exists pointConstraintWeight`) {
        optionVar -floatValue pointConstraintWeight 1.0;
    }

    // offset values
    //
    if ($forceFactorySettings ||
        !`optionVar -exists ptConstOffsetX`) {
        optionVar -floatValue ptConstOffsetX 0.0;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists ptConstOffsetY`) {
        optionVar -floatValue ptConstOffsetY 0.0;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists ptConstOffsetZ`) {
        optionVar -floatValue ptConstOffsetZ 0.0;
    }

    // maintain existing offset
    //
    if ($forceFactorySettings ||
        !`optionVar -exists ptConstMaintainOffset`) {
        optionVar -intValue ptConstMaintainOffset 0;
    }

    // constraint axes
    //
    if ($forceFactorySettings ||
        !`optionVar -exists  pointConstraintAxisX`) {
        optionVar -intValue pointConstraintAxisX true;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists  pointConstraintAxisY`) {
        optionVar -intValue pointConstraintAxisY true;
    }
    if ($forceFactorySettings ||
        !`optionVar -exists  pointConstraintAxisZ`) {
        optionVar -intValue pointConstraintAxisZ true;
    }

}

//
//  Procedure Name:
//      pointConstraintSetup
//
//  Description:
//        Update the state of the option box UI to reflect the option values.
//
//  Input Arguments:
//      parent               - Top level parent layout of the option box UI.
//                             Required so that UI object names can be
//                             successfully resolved.
//
//        forceFactorySettings - Whether the option values should be set to
//                             default values.
//
//  Return Value:
//      None.
//
global proc pointConstraintSetup(string $parent, int $forceFactorySettings)
{
    //    Retrieve the option settings
    //
    setOptionVars($forceFactorySettings);

    setParent $parent;

    //    Query the optionVar's and set the values into the controls.

    //    weight
    //
    floatSliderGrp -edit
        -value `optionVar -query pointConstraintWeight`
        pointConstraintWeight;

    //    Offset values
    //
    float $tx = `optionVar -query ptConstOffsetX`;
    float $ty = `optionVar -query ptConstOffsetY`;
    float $tz = `optionVar -query ptConstOffsetZ`;
    if (`optionVar -query ptConstMaintainOffset`) {
        checkBoxGrp -edit -value1 1 pointConstraintMaintainWidget;
        floatFieldGrp -edit -enable 0 offsetField;
    } else {
        checkBoxGrp -edit -value1 0 pointConstraintMaintainWidget;
        floatFieldGrp -edit -enable 1 offsetField;
    }
    floatFieldGrp -e -v1 $tx -v2 $ty -v3 $tz offsetField;

    //  Axis values
    //
    int $axisX = `optionVar -query pointConstraintAxisX`;
    int $axisY = `optionVar -query pointConstraintAxisY`;
    int $axisZ = `optionVar -query pointConstraintAxisZ`;
    // if all axes are on, select the all box and dim the individual axes
    if ($axisX && $axisY && $axisZ) {
        checkBoxGrp -edit -value1 true axesAll;
        checkBoxGrp -edit -value1 false -value2 false -value3 false axesXYZ;
    }
    // otherwise just select those boxes corresponding to 'on' axes
    else {
        checkBoxGrp -edit -value1 false axesAll;
        checkBoxGrp -edit -value1 $axisX -value2 $axisY -value3 $axisZ axesXYZ;     }
}

//
//  Procedure Name:
//      pointConstraintCallback
//
//  Description:
//        Update the option values with the current state of the option box UI.
//
//  Input Arguments:
//      parent - Top level parent layout of the option box UI.  Required so
//               that UI object names can be successfully resolved.
//
//        doIt   - Whether the command should execute.
//
//  Return Value:
//      None.
//
global proc pointConstraintCallback(string $parent, int $doIt)
{
    setParent $parent;

    //    Set the optionVar's from the control values, and then
    //    perform the command.

    //    weight
    //
    optionVar -floatValue pointConstraintWeight
        `floatSliderGrp -query -value pointConstraintWeight`;

    // maintain offset
    //
    optionVar -intValue ptConstMaintainOffset `checkBoxGrp  -query -value1 pointConstraintMaintainWidget`;

    //    Offset values
    //
    optionVar -floatValue ptConstOffsetX
        `floatFieldGrp -query -v1 offsetField`;
    optionVar -floatValue ptConstOffsetY
        `floatFieldGrp -query -v2 offsetField`;
    optionVar -floatValue ptConstOffsetZ
        `floatFieldGrp -query -v3 offsetField`;

    // Axis values
    //

    // Either the 'All' box is checked (and so all axes are on) ...
    if ( `checkBoxGrp -query -value1 axesAll` ) {
        optionVar -intValue pointConstraintAxisX true;
        optionVar -intValue pointConstraintAxisY true;
        optionVar -intValue pointConstraintAxisZ true;
    } else {
        // ... Or only those axes specifically selected are on
        optionVar -intValue pointConstraintAxisX
            `checkBoxGrp -query -value1 axesXYZ`;
        optionVar -intValue pointConstraintAxisY
            `checkBoxGrp -query -value2 axesXYZ`;
        optionVar -intValue pointConstraintAxisZ
            `checkBoxGrp -query -value3 axesXYZ`;
    }

    if ($doIt) {
        performPointConstraint 0;
        addToRecentCommandQueue "performPointConstraint 0" "PointConstraint";
    }
}

//
//  Procedure Name:
//      pointConstraintOptions
//
//  Description:
//        Construct the option box UI.  Involves accessing the standard option
//        box and customizing the UI accordingly.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      None.
//
proc pointConstraintOptions()
{
    //    Name of the command for this option box.
    //
    string $commandName = "pointConstraint";

    //    Build the option box actions.
    //
    string $callback = ($commandName + "Callback");
    string $setup = ($commandName + "Setup");

    //    Get the option box.
    //
    string $layout = getOptionBox();
    setParent $layout;

    //    Pass the command name to the option box.
    //
    setOptionBoxCommandName($commandName);

    //    Activate the default UI template.
    //
    setUITemplate -pushTemplate DefaultTemplate;

    //    Turn on the wait cursor.
    //
    waitCursor -state 1;

    tabLayout -scr true -tv false;
    string $parent = `columnLayout -adjustableColumn 1`;

    checkBoxGrp
        -label "Maintain Offset"
        -label1 " "
        -annotation "Preserve the initial offset between the object and the target(s)"
        -numberOfCheckBoxes 1
        -cc ("floatFieldGrp -edit -enable (! #1) offsetField;")
        pointConstraintMaintainWidget;

    floatFieldGrp -label "Offset"
        -numberOfFields 3
        offsetField;

    separator;
    //      Constraint Axes Selection Boxes
    //

    // The 'axesAll' checkBoxGrp and the 'axesXYZ' checkBoxGrp are linked
    // such that when 'axesAll' is selected, all the 'axesXYZ' boxes are
    // unselected. And when any 'axesXYZ' box is selected the 'axesAll'
    // box is deselected.
    checkBoxGrp -numberOfCheckBoxes 1 -label "Constraint Axes"
        -label1 "All"
        -onCommand ("checkBoxGrp -edit " +
                    "-value1 false " +
                    "-value2 false " +
                    "-value3 false " +
                    "axesXYZ")
        axesAll;

    checkBoxGrp -numberOfCheckBoxes 3
        -label1 "X"
        -label2 "Y"
        -label3 "Z"
        -onCommand ("checkBoxGrp -edit " +
                    "-value1 false " +
                    "axesAll;")
        axesXYZ;

    separator;

    floatSliderGrp -label "Weight"
        -field true -min 0.0 -max 10.0
        pointConstraintWeight;

    //    Turn off the wait cursor.
    //
    waitCursor -state 0;

    //    Deactivate the default UI template.
    //
    setUITemplate -popTemplate;

    //    'Apply' button.
    //
    string $applyBtn = getOptionBoxApplyBtn();
    button -edit
        -label "Add"
        -command ($callback + " " + $parent + " " + 1)
        $applyBtn;

    //    'Save' button.
    //
    string $saveBtn = getOptionBoxSaveBtn();
    button -edit
        -command ($callback + " " + $parent + " " + 0 + "; hideOptionBox")
        $saveBtn;

    //    'Reset' button.
    //
    string $resetBtn = getOptionBoxResetBtn();
    button -edit
        -command ($setup + " " + $parent + " " + 1)
        $resetBtn;

    //    Set the option box title.
    //
    setOptionBoxTitle("Point Constraint Options");

    //    Customize the 'Help' menu item text.
    //
    setOptionBoxHelpTag( "Point" );

    //    Set the current values of the option box.
    //
    eval (($setup + " " + $parent + " " + 0));

    //    Show the option box.
    //
    showOptionBox();
}

//
//  Procedure Name:
//      pointConstraintHelp
//
//  Description:
//        Return a short description about this command.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      string.
//
proc string pointConstraintHelp()
{
    // ******** Example
    // "  Command: Extrude - create a surface using extrusion.\n" +
    // "Selection: curves and isoparms."

    return
    "  Command: pointConstraint - <what it does.>\n" +
    "Selection: <A list of things that can be selected>";
}

//
//  Procedure Name:
//      assembleCmd
//
//  Description:
//        Construct the command that will apply the option box values.
//
//  Input Arguments:
//      None.
//
//  Return Value:
//      None.
//
proc string assembleCmd()
{
    string $cmd = "pointConstraint";

    setOptionVars(false);

    if (`optionVar -query ptConstMaintainOffset`) {
        $cmd = ($cmd + " -mo");
    } else {
        //    Translate values
        //
        float $tx = `optionVar -query ptConstOffsetX`;
        float $ty = `optionVar -query ptConstOffsetY`;
        float $tz = `optionVar -query ptConstOffsetZ`;
        $cmd = ($cmd + " -offset " + $tx + " " + $ty + " " + $tz );
    }

    // Axis values
    //

    // The axis values are inverted so that they represent
    // which axes to *skip* as opposed to which axes are on.
    int $axisX = !`optionVar -query pointConstraintAxisX`;
    int $axisY = !`optionVar -query pointConstraintAxisY`;
    int $axisZ = !`optionVar -query pointConstraintAxisZ`;

    // If any of these values is true, that means that one
    // or more axes are to be skipped.
    if ($axisX)
        $cmd = ($cmd + " -skip x");
    if ($axisY)
        $cmd = ($cmd + " -skip y");
    if ($axisZ)
        $cmd = ($cmd + " -skip z");

    $cmd = ($cmd +
            " -weight " + `optionVar -query pointConstraintWeight`);

    return $cmd;
}

//
//  Procedure Name:
//      performPointConstraint
//
//  Description:
//        Perform the pointConstraint command using the corresponding
//        option values.  This procedure will also show the option box
//        window if necessary as well as construct the command string
//        that will invoke the pointConstraint command with the current
//        option box values.
//
//  Input Arguments:
//      0 - Execute the command.
//      1 - Show the option box dialog.
//      2 - Return the command.
//
//  Return Value:
//      None.
//
global proc string performPointConstraint(int $action)
{
    string $cmd = "";

    switch ($action) {

        //    Execute the command.
        //
        case 0:
            //    Retrieve the option settings
            //
            setOptionVars(false);

            //    Get the command.
            //
            $cmd = `assembleCmd`;

            //    Execute the command with the option settings.
            //
            evalEcho($cmd);

            break;

        //    Show the option box.
        //
        case 1:
            pointConstraintOptions;
            break;

        //    Return the command string.
        //
        case 2:
            //    Retrieve the option settings.
            //
            setOptionVars (false);

            //    Get the command.
            //
            $cmd = `assembleCmd`;
            break;
    }
    return $cmd;
}